home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / basic / bds.zip / BDS.DOC < prev   
Text File  |  1986-07-24  |  14KB  |  288 lines
  1.      A    AUTO            < , >          Place current line in center of page
  2.      C    CLS             < . >          List current program line
  3.      D    DELETE          < - >          List previous program line
  4.      E    EDIT            < + >          List next program line
  5.      L    LIST            <PgUp>         List previous page of lines
  6.      L"   LOAD"           <PgDn>         List next page of lines
  7.      M    MERGE           <Ctrl><PgUp>   List first page of lines
  8.      P    LLIST           <Ctrl><PgDn>   List last page of lines
  9.      S"   SAVE
  10.      U    Un-NEW                     Single Step Trace Commands
  11.                            SYSTEM TROFF                       disable SST
  12.                            SYSTEM TRON [LINE] [lineno]        enable  SST
  13.  
  14.      COMPRESS                            UNCOMPRESS
  15.      H [RL,NC,LB,LR,LT,SD,SP,RV]         I [E L D I T]
  16.  
  17.      Where:                              Where:
  18.           RL  Remove Lines                    E  Expanded option
  19.           NC  No Combination                  L  Line Indentation
  20.           LB  Leave Blanks                    D  DATA item seperation
  21.           LR  Leave Remarks                   I  Indent loop suppress
  22.           LT  Leave Type chars                T  Type char suppress
  23.           SD  Shorten and Display
  24.           SP  Shorten and Print
  25.           RV  Remove Variables
  26.  
  27.                                 VARIABLE DUMP
  28.  
  29.           V .                List all variables to the screen
  30.           V ,                List all variables to the printer
  31.           V .vn              List variables to the screen in ascending order,
  32.                              starting with the specified variable
  33.               V ,vn          List variables to the screen in ascending order,
  34.                              starting with the specified variables
  35.           V .vn,vn[,vn,]...  List the specified variables to the screen
  36.           V ,vn,vn[,vn,]...  List the specified variables to the printer
  37.           V vn[,vn,]...      List the specified variable(s) to the screen
  38.           V                  Repeat the previous V command
  39.  
  40.  
  41.                                  SUPER RENUM
  42.  
  43.           R [newline] [,[increment] [,[startline] [,endline]]]
  44.                      Renumber and/or relocate a block of program lines
  45.           R I [newline] [,[increment] [,[startline] [,endlling]]]
  46.                      Duplicate a block of program lines
  47.           R U
  48.                      Scan program for unidenfined lines
  49.  
  50.               VARIABLE/LINE NUMBER/NUMERIC CONSTANT CROSS-REFERENCE
  51.  
  52.            X .         List all references to the screen
  53.            X ,         List all references to the printer
  54.            X .ppppp    List all references starting with ppppp to the screen
  55.            X ,ppppp    List all references starting with ppppp to the printer
  56.            X ppppp     List all references to ppppp to the screen
  57.            X           List to the screen the 'next' program line which
  58.                        contains a reference to the last X ppppp command
  59.  
  60.  
  61.                         STRING/KEYWORD CROSS-REFERENCE
  62.  
  63.             F .REM     List program lines containing REM to the screen
  64.             F ,REM     List program lines containing REM to the printer
  65.             F .        List all keyword references to the screen
  66.             F ,        List all keyword references to the printer
  67.             F ."kw     List keyword references to the screen in ascending
  68.                        sequence starting with kw
  69.             F ,"kw     List keyword references to the screen in ascending
  70.                        sequence starting with kw
  71.             F ."ss"    List string references to the screen in ascending
  72.                        sequence starting with ss
  73.             F ,"ss"    List string references to the screen in ascending
  74.                        sequence starting with ss
  75.             F "kw      List references to kw to the screen
  76.             F "ss"     List string references which CONTAIN ss to the screen
  77.             F "kw1+kw2 List references in which kw1 and kw2 appear in the
  78.                        program line to the screen
  79.             F "kw1,kw2 List references to kw1 to the screen and REPLACE
  80.                        each occurrence of kw1 with kw2
  81.             F          List the 'next' program line containing a reference to
  82.                        the last F "kw or F "ss" command
  83.  
  84. COMPRESS
  85. ~~~~~~~~
  86.           This module reduces the size of the resident program to an absolute
  87. minimum for optimal execution under the BASIC interpreter.  Programs which
  88. have been so compressed typically occupy 30 to 40% less memory space, and
  89. run 7 to 10% faster.
  90.  
  91. The compression is accomplished through the fillowing actions:
  92.  
  93.          1) Remove remarks.
  94.          2) Remove unneccessary blanks.
  95.          3) Remove extraneous colons.
  96.          4) Remove quotation marks at the end of a line, unless the quote is
  97.             required to retain a trailing blank.
  98.          5) Remove the LET keyword.
  99.          6) Remove the GOTO keyword in the sequences THEN GOTO and ELSE GOTO.
  100.          7) Remove variable type declaration characters ($,%,!,#) when a
  101.             previous DEFINT, DEFSTR, DEFSNG, or DEFDBL statement makes
  102.             such explicit typing redundant.
  103.          8) Merge separate lines into single multiple-statement lines.
  104.          9) Remove any non-executable program lines, i.e. unreferenced lines
  105.             which follow GOTO,RETURN or END statements.
  106.         10) Remove variable names from NEXT statements.
  107.         11) Automatically shorten variable names.
  108.  
  109.  
  110. Items 3 and 4 are not optional, but the remaining actions are controlled by
  111. parameter.  The default state for items 9,10,and 11 is OFF, while the
  112. default for all other items is ON.
  113.  
  114. For item 7 to function correctly, the DEFxxx (where xxx = INT,STR,SNG,or DBL)
  115. statements must appear in a physical order corresponding to there logical
  116. order.  If DEFxxx statements appear in subroutines which are referenced by
  117. GOSUB statements, those lines which appear in the program physically before
  118. the DEFxxx statements will be treated as if the DEFxxx statement was not in
  119. effect.  Therefore, in order to take maximum advantage of this feature, the
  120. DEFxxx statements should be at or near the beginning of the program.
  121.  
  122. Although item 10 normally saves a few bytes, the primary opjective in removing
  123. the variable names from NEXT statements is to improve the performance of the
  124. program.  Our benchmark tests show that FOR/NEXT loops execute up to 25%
  125. faster with the variable names ommitted.
  126.  
  127. Compress is invoked with the H command, optionally followed by one or more
  128. parameters to tailor the compression to your specific requirements.
  129. Mutiple parameters must be separated by commas.
  130. The parameters are:(The envelope please)
  131.  
  132. RL    Remove Lines (#9). Non-executable lines are removed.
  133.  
  134. NC    No Combination (#8). Seprate lines are not merged into multiple-statement
  135.       lines.  Inhibits removal of non-executable program lines (#9), even if
  136.       the RL parameter is specified.
  137.  
  138. LB    Leave Blanks (#2).  Blanks are not removed.  This also disables removal
  139.       of LET (#5) and GOTO (#6) keywords.  Under certain circumstances, a
  140.       very few blanks may be removed, even with this option set.
  141.  
  142. LR    Leave Remarks (#1). Remarks are not removed.
  143.  
  144. LT    Leave Typing characters (#7).  Variable type declaration characters
  145.       are not removed.
  146.  
  147. SD    Shorten and Display (#11).  Specifies that you want to shorten variable
  148.       names and sent the new/old variable nave list to the Display.
  149.       Variable names which are already less than four(4) characters in
  150.       length are not shortened.  The new variable names will be two or three
  151.       characters long and will retain the same first letter as the old
  152.       variable name.
  153.  
  154. SP    Shorten and Print (#11).  Specifies that you want to shorten variable
  155.       names and send the new/old variable name list to the Printer.
  156.       When using this parameter, a printer fault such as out-of-paper or
  157.       printer off-line will terminate the compress